home *** CD-ROM | disk | FTP | other *** search
/ Nightshift Sound & Vision / Nightshift - Sound & Vision.iso / programs / sound / randsam / randsam.doc < prev    next >
Text File  |  1990-08-11  |  3KB  |  90 lines
  1.         Randsam - a Random sample player
  2.  
  3. This is PUBLIC DOMAIN.
  4. This program was written by Steven Lagerweij.
  5. The Idea from Bas van Andel.
  6.  
  7. What is randsam ?
  8.     randsam is a program that plays random soundsamples at random
  9.     times, with random volume, random cycles, and a bit random period.
  10. Randsam consists of two programs which are QUITRAND and RANDSAM.
  11.  
  12. RANDSAM should be run in the background (run,runback etc).
  13. Randsam has no options.
  14.  
  15. Quitrand is used to ask randsam things.
  16. Quitrand knows the following options:
  17.     play   Ask randsam to play all available samples
  18.  
  19.     conf   This displays some settings in randsam
  20.  
  21.            If you like to monitor randsam for a while:
  22.            copy quitrand ram:
  23.            resident c:execute
  24.            Then make a script like this one :
  25.            ram:quitrand conf
  26.            execute scriptname
  27.  
  28.     quit   Tell randsam you don't want him anymore
  29.  
  30. To run randsam a config-file must exist in s: and it's name must be play.config
  31. This play.config file has the following form
  32.  
  33. ----------------------------------|----------------------------|
  34.  ConfigFile form :          | Example config :           |
  35. ----------------------------------|----------------------------|
  36.  mindelay maxdelay maxdiff      | 5 900 100               |
  37.  mincyc maxcyc              | 1 3                |
  38.  numsamples              | 3                   |
  39.  sample1 speed volume cyclenum      | disk:dir/file1 428 64 1    |
  40.  ...                  | disk:dir/file2 428 0 0     |
  41.  ...                  | dsk2:ddd/lala3 210 50 4    |
  42. ----------------------------------------------------------------
  43.  
  44.  
  45. mindelay :  Is the minimum waittime between samples in SECONDS.
  46. maxdelay :  Is the maximum waittime between samples in SECONDS.
  47. maxdiff  :  Is the maximum value that can be subtracted or added
  48.         to the period value of the current sample.
  49. mincyc     :  Is the minimum number cycles.
  50. maxcyc     :  Is the maximum number of cycles.
  51. Numsamples: this number is the number of samples described after this value.
  52.  
  53. sample1  : COMPLETE filepath to open the sample.
  54. speed     : The period (sample speed) value of the sample.
  55. volume     : replay volume. If the volume is 0 a random volume value is taken.
  56. cyclenum : The number of times that the sample will be repeated.
  57.        if the 'cyclenum' of the current sample is zero
  58.        and 'maxcyc' is not zero , only then a
  59.        random number is taken between mincyc and maxcyc.
  60.  
  61. NOTE that: Each value may be seperated by either a space or a CR (return).
  62.        You MUST enter ALL values in the order shown above.
  63.        Do NOT use SPACES in the FILENAMES! (NOT possible!)
  64. --------------------------------------------------------------------
  65.  
  66.  
  67. Source Code is included. It was compiled with lattice C v4.0
  68. If you modify it please send me the 'update', and tell me what you've done.
  69. please leave my name in the program.
  70.  
  71. These progams are only to be distributed as public domain.
  72. Otherwise don't sell these programs without my permission.
  73.  
  74. Distribution:
  75. Always include the following files :
  76.                     randsam       executable
  77.                     Quitrand       executable
  78.                     randsam.doc    This file
  79.                     Quitrand.c       Source Code
  80.                     randsam.c       Source Code
  81.                     randcmd.h       Source hdr
  82.                     play.config    sample config
  83.  
  84. Any suggestions, donations, bugs, annoying things, well whatever
  85. can be send to:
  86.         Steven Lagerweij
  87.         Buizerdstraat 4
  88.         4143BA
  89.         Leerdam, Netherland
  90.